home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / rbq403.zip / RBBSQUOT.DOC < prev    next >
Text File  |  1992-07-25  |  12KB  |  317 lines
  1. RBBSQUOT Documentation 
  2.  
  3. Copyright (C) 1992 by Kevin Day.
  4.  
  5. What is RBBSQUOT?
  6.  
  7. RBBSQUOT allows you to add a 'Quote-of-the-day' to RBBS, Wildcat! or any other
  8. BBS program(as long as it can either run a daily maintance program, or run
  9. RBBSQUOT.EXE after each caller)
  10.  
  11. Requirements:
  12.  
  13. At least 256K of RAM... (who doesn't have at least 640 any more?)
  14. Hard drive STRONGLY recommended (or you will get to sit there forever waiting)
  15. About 192K of drive space
  16. A 286 is recommended, although it will work just fine on an 8088
  17. FILES=15 or higher in your config.sys
  18. MS-DOS 3.1 or higher(sorry 2.11 fans)
  19. A twisted sense of humor to understand some of my quotes(optional)
  20.  
  21.  
  22. Features/Supports:
  23. ------------------------
  24. o Works on RBBS
  25. o Wildcat!
  26. o PCBoard
  27. o Spitfire
  28. o Unsure about TBBS(if anyone tries, let me know)
  29. o Unsure about MajorBBS(shouldn't work unless you are using Desqview)
  30. o *Enhanced* Desqview support
  31. o MS-DOS 5.0 Support
  32. o PC-DOS support
  33. o QEMM/386 Support
  34. o Uses CON instead of writing directly to the screen(for multitasker support)
  35. o Novell Netware support
  36. o Lantastic support
  37. o Netware/Lite support
  38. o ANSI support
  39. o Supports 7 bit callers
  40. o Takes about 5 seconds to run
  41.   (test conducted on my 386DX/33 under DesqView with two background nodes)
  42. o Drive/path selectable
  43.  
  44.         DISCLAIMER ABOUT INCLUDED QUOTES;
  45.  
  46.             I will not be held liable for any irate barbs flung by
  47.             users at SysOps!  If their minds are *that* closed,
  48.             perhaps the SysOp should shut them out...
  49.  
  50. (kinda stole that from james pariseau, if he complains, i'll take that out)
  51.  
  52.  
  53. How to get started....
  54.  
  55. 1) Make sure you have all the files in the same directory somewhere....
  56. 2) Type RBBSCNF (configuration program for RBBSQUOT)
  57.    (make sure BRUN45.EXE is somewhere in the current path, I included a copy)
  58. 3) Read the nice message when it loads....
  59. 4) Print out the registeration form. Option 1.....
  60. 5) Select 2, to setup the program.
  61. 6) You are presented with a list of options. Number 1 is to select the path of
  62.    the QUOTE file..... All you should ever need to change is the path, the
  63.    QUOTE file comes named RBBSQUOT.QUO. You should rarely need to change this.
  64.    Ex. If you unzipped this in the D:\RBBS directory, you would change it to
  65.    D:\RBBS\RBBSQUOT.QUO   simple, eh?
  66. 7) The next option you need to be concerned with is 4. It asks if you wish to
  67.    have the date that the quote is made on included with the quote. If you
  68.    choose Y it will look like:
  69.  
  70.  We  have  a equal opportunity Calculus class -- it's fully integrated.
  71.  
  72. Quote created on: Wednesday, April 22, 1992
  73. * RBBSQUOT 4.01 * SN: XXXXX * Some BBS Out there *
  74. Copyright (C) 1991-1992 Kevin Day * All Rights Reserved Worldwide
  75.  
  76.    if you choose N, it will look like
  77.  
  78.  We  have  a equal opportunity Calculus class -- it's fully integrated.
  79.  
  80. * RBBSQUOT 4.01 * SN: XXXXX * Some BBS Out there *
  81. Copyright (C) 1991-1992 Kevin Day * All Rights Reserved Worldwide
  82.  
  83. 8) Now you need to decide if you want date information included with the quote
  84.    if you choose yes, the quote will look like:
  85.  
  86.  We  have  a equal opportunity Calculus class -- it's fully integrated.
  87.  
  88. Information on: 04-22-1992 It is the 113 day in the year
  89. It is the 33715 day of the century. Christmas is 246 days from now!
  90. * RBBSQUOT 4.01 * SN: XXXXX * Some BBS Out there *
  91. Copyright (C) 1991-1992 Kevin Day * All Rights Reserved Worldwide
  92.  
  93. 9) Select save, then exit the program.
  94.  
  95. 10) Now you need to setup the RBBSQUOT.FIL file. This is the only tricky part
  96.     of the program. This file shows RBBSQUOT where your welcome files are and
  97.     what to do with them.
  98.  
  99. *************************************************************************
  100.  
  101. RBBS INSTRUCTIONS:
  102.  
  103.    a) RENAME your WELCOME, WELCOMEG, and WELCOMEC to WELCOME.Q,WELCOMEG.Q, and
  104.       WELCOMEC.Q (You could use any name you wanted to, this is just what I
  105.       use.)
  106.    b) Now use your favorite text editor, edit the WELCOME.Q and WELCOMEG.Q and
  107.       the WELCOMEC.Q, and where you'd like to have the quote
  108.       displayed insert the line @QUOTE@ (If this conflicts with something,
  109.       I can't see why, but if @QUOTE@ is used somewhere else in the file, go
  110.       ahead and use something else, just change it in the RBBSQUOT.FIL too)
  111.       ex.
  112.  
  113. Before:   Welcome to the xxxxxxxx BBS!
  114.           blah, blah, blah
  115.           blah, blah, blah
  116.  
  117. After:    Welcome to the xxxxxxxx BBS!
  118.           blah, blah, blah
  119.           {FN, your quote today is:
  120.           @QUOTE@
  121.           blah, blah, blah
  122.  
  123. get the idea?
  124.  
  125.     c) Now use your favorite text editor again and create a file called
  126.        RBBSQUOT.FIL.  RBBSQUOT.FIL is a comma-delimited ASCII file with
  127.        this format:
  128.  
  129. SOURCE,DESTINATION,STRING TO REPLACE,FILE TYPE
  130.  
  131.     Source represents the file you have edited and put the @QUOTE@ string
  132. in(WELCOME.Q in our example). DESTINATION is where RBBSQUOT puts the new file,
  133. (WELCOME in our example). STRING TO REPLACE is @QUOTE@ . File type is:
  134.  
  135.     0 to include low ascii only.. (letters, numbers and symbols)
  136.     1 to include all 256 ascii chars. (fancier symbols)
  137.     2 to include ANSI also.
  138.  
  139. ex. (my RBBSQUOT.FIL file)
  140.  
  141. D:\RBBS\WELCOME.Q,D:\RBBS\WELCOME,@QUOTE@,0
  142. D:\RBBS\WELCOMEG.Q,D:\RBBS\WELCOMEG,@QUOTE@,1
  143. D:\RBBS\WELCOMEC.Q,D:\RBBS\WELCOMEC,@QUOTE@,2
  144.  
  145. This file tells RBBSQUOT to read in WELCOME.Q, look for @QUOTE@ and insert
  146. a quote using low ascii only, and write it to WELCOME.... understand?
  147.  
  148. *************************************************************************
  149.  
  150. Wildcat! instructions:
  151.  
  152. Follow the above, but where WELCOMEC is mentioned, use WELCOMEx.SCR
  153. and where WELCOME is mentioned, use WELCOMEx.BBS, ignore references
  154. to WELCOMEG...
  155.  
  156. (the x represents a number)
  157.  
  158. *************************************************************************
  159.  
  160.  
  161. Now add a line in your nightly maintance batch file to run RBBSQUOT.... that's
  162. all!
  163.  
  164.  
  165.  
  166. TO USE RANDOMIZED QUOTES:
  167.  
  168. If you would prefer to have RBBSQUOT select quotes randomly instead
  169. of going through them one by one, here's what you do:
  170.  
  171. go into option 2 of RBBSCNF and change option 2 to Random instead
  172. of Sequential. Save it, then select option three to rebuild the
  173. index file,(YOU MUST rebuild the index file EVERY time you change
  174. the file).
  175.  
  176. That's it!
  177.  
  178.  
  179.  
  180. Need more help?
  181.  
  182. Call or write or BBS or FAX me at:
  183.  
  184. Kevin Day
  185. 2116 Market Lane
  186. Norfolk, Nebraska
  187. 68701-4500
  188. USA
  189.  
  190. Voice: (402)379-1606
  191. Modem: (402)371-1472
  192. FAX  : (402)371-2663
  193.  
  194. ******************************************************************************
  195.  
  196. What do you get when you register?
  197.  
  198. o  A Printed, Bound manual for RBBSQUOT listing ALL of it's features,
  199. and more ideas on how to use it, etc.
  200. o  The >LATEST< version on disk(sometimes even before released on BBS's)
  201. o  A registeration code to stop that annoying 'REGISTER' message after
  202.    each message...
  203. o  FREE 6 month subscription to the bbs
  204. o  FREE 6 month subscription to the kevin bbs newsletter, containing news
  205.    about RBBSQUOT. (12 issues)
  206. o  A catalog of all products sold by me
  207.  
  208. How much does registering cost?
  209.  
  210. $20 for the standard registeration, with everything above.
  211.  
  212.  
  213. ******************************************************************************
  214.  
  215.  
  216. Files included in .ZIP:
  217.  
  218. RBQREG   EXE      6982 04-22-92   6:20p  Program used after registering
  219. RBBSCNF  EXE     12318 07-25-92   2:53a  Configuration program
  220. BRUN45   EXE     77440 09-28-88   1:43a  Required program to run
  221. MESSUP   BAS       451 01-12-92   2:39p  Fun Example of a QB bug
  222. RBBSQUOT QUO    129754 07-25-92   3:17a  Quote file
  223. RBBSQUOT DOC     12379 07-25-92   3:23a  This file
  224. RBBSQUOT EXE     17864 07-25-92   3:21a  Main RBBSQUOT EXE file.
  225. FIXSHIFT COM       690 10-06-87  10:49a  May fix probs with OLD AT keyboards
  226. PATCH87  EXE      4206 07-01-88   3:03p  May fix DOS 3.20 bug
  227.  
  228. ******************************************************************************
  229. Don't forget to send in your registeration money!
  230. ******************************************************************************
  231.  
  232.  
  233.  
  234. RBBSQUOT history:
  235.  
  236.     1.0  ??/??/91  Only two people ever saw this release. Very primitive
  237.         
  238.         2.0  ??/??/91  First public release of RBBSQUOT. Three registerations.
  239.  
  240.         3.0  ??/??/91  Never released, major enhancements to 2.0 but was lost
  241.                        in a hard drive failure and backups were destroyed....
  242.  
  243.     4.0  04/22/92  Although 5 months behind schedule, finally released.
  244.                Second public release of RBBSQUOT. Added date info.
  245.  
  246.        4.01  05/04/92  Fixed CR/LF bug, thanks to Don Rowe for reporting...
  247.                Seems that if you had all date info shut off, it would
  248.                   'forget' to add a CR/LF..... Fixed now... 
  249.                        Added DEBUG support in case of error, and more error
  250.                    checking. Trapped error if RBBSQUOT was registered but
  251.                        RBBSQUOT.REG was erased...
  252.  
  253.        4.02  06/29/92  Fixed bug about incorrectly reporting an error about
  254.                a 0 byte file. Added more Desqview support. Added
  255.                 compatibility test to RBBSCNF which will show if
  256.                RBBSQUOT won't work or not on your system.
  257.                Added FIXSHIFT.COM to archive. May fix some problems
  258.                with old AT keyboards and RBBSCNF.
  259.  
  260.        4.02A 07/16/92  Added PATCH87.EXE to the archive, fixed problems
  261.                    with MS-DOS 3.20.... (didn't think anyone still used
  262.                        it!) Fixed another TEENSY problem... Forgot to add
  263.                 A CR/LF after each line on multi-line quotes!
  264.  
  265.        4.03  0?/??/??  Thanks to Will Kaberline for reporting a mistake
  266.                in RBBSQUOT.DOC... Also fixed problem of it
  267.                        incorrectly reporting errors. Also removed some
  268.                unneeded modules in the source code, shrunk the size
  269.                from 28K to 22K...(not bad)... Added error checking
  270.                        that improves error detection extrodinarily, and
  271.                        only adds 1K to the program size.  Added ability
  272.                to use Random quotes as well as sequential. Fixed
  273.                bug where it claimed to 'detect' desqview even if
  274.                you weren't using it. (would detect version -1).
  275.                        Added another 60K of quotes to file.
  276.  
  277. Registered Users:
  278. Name            Numbr BBS Name               Type       Phone
  279. Don Rowe        00001 Threshold of Origin    RBBS       509-453-3283
  280. John Houck      00002 The Temples of Syrinx  RBBS       509-452-1868
  281. Del Bice        00003 Sigma Iotia ][         RBBS       509-965-0467
  282. Eddie Rowe      00004 HOTLine RBBS           RBBS       318-254-0019
  283. Tim Sawchuck    00005 The Nasty Old Lady     Wildcat!   805-528-7341
  284. Ryan Strayer    00006 Software Connection    RBBS       712-274-1851
  285. Stephen McClymo 00007 Stealth Systems        RBBS       817-862-5500
  286.  
  287.  
  288. Where can you find RBBSQUOT?
  289.  
  290. Authorized RBBSQUOT distribution sites:
  291.  
  292. Name                Number        Rate/modulation     Sysop
  293. ----------------------------------------------------------------------
  294. The Kevin BBS       402-371-1472  14400 HST/V.32bis   Kevin Day(me)
  295. Stealth Systems BBS 817-862-5500  2400                Stephen McClymont Jr.
  296. Sigma Iotia ][      509-965-0467  14400 HST           Del Bice
  297.  
  298.  
  299. Acknowlegements:
  300.  
  301. I would like to thank Don Rowe for being the first person to register ANY
  302. of my programs, and for writing the ONLY(as far as i know) Chat door for
  303. RBBS. I also would like to thank Del Bice for his INCREDIBLE patience for
  304. the registered version of RBBSQUOT, he has waited long enough for this. Also,
  305. these people have played a part(although some indirectly, such as creating
  306. 'taglines' which i converted into quotes):
  307.  
  308.  
  309. Emily Spicer     Johnna Hartz     Tim Sawchuck     John Houck
  310. Gary Matteson    Eric Schomaker   Alan Davenport(for giving me a pastime! YT!)
  311. Gianluca Attura (for letting me compile some routines on his 486!)
  312. All the wonderful people at Microsoft who put all the little bugs into
  313. QuickBasic 4.5 to make programming interesting(See MESSUP.BAS included)
  314. Minos Tsaussis   for giving me a forum to babble on.
  315.          Thanks Minos, where ever you are. If you're ever in the
  316.                  area stop by...... We're all thinking of you.
  317.